Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Configuration Functions for Sound Channel Components

SGGetSoundInputParameters

The SGGetSoundInputParameters function allows the sequence grabber to retrieve some parameters that relate to sound recording.

pascal ComponentResult SGGetSoundInputParameters (SGChannel c, 
                                       short *sampleSize,
                                       short *numChannels, 
                                       OSType *compressionType);

c

Identifies the channel connection for this operation.

sampleSize

Contains a pointer to a field to receive the sample size. Set this field to 8 for 8-bit sound; set the field to 16 for 16-bit sound.

numChannels

Contains a pointer to a field to receive the number of sound channels used by the sound sample. Set this field to 1 for monaural sounds; set the field to 2 for stereo sounds.

compressionType

Contains a pointer to a field to receive the format of the sound data. You may return the following values:

'raw '

Sound samples are uncompressed, in offset-binary format (that is, sample data values range from 0 to 255).

'MAC3'

Sound samples have been compressed by the Sound Manager at a ratio of 3:1.

'MAC6'

Sound samples have been compressed by the Sound Manager at a ratio of 6:1.

DESCRIPTION

The sequence grabber may use the SGGetSoundInputParameters function to retrieve many parameters relating to sound recording. If any of the sound parameters are set to nil, do not return that value.